home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 015a / cusort23.zip / CUSORT.DOC < prev    next >
Text File  |  1993-04-01  |  8KB  |  204 lines
  1. |    Colorado Utilities Sort (CUSORT v.2.3)
  2. |
  3. |    by
  4. |
  5. |    Fred C. Hill
  6. |
  7. |    Micro System Solutions
  8. |    5048 W. Maplewood Ave.
  9. |    Littleton, CO 80123
  10. |    1-(303) 795-7653
  11. |    1-(800) 421-1789 (orders)
  12. |
  13. Sorting is one of those things every computer user must do at one time or 
  14. another, and the sort program provided with most versions of DOS just 
  15. doesn't do the job. It's slow; only sorts from column one; won't sort 
  16. descending; has a limited capacity; and only uses regular memory to sort in. 
  17. Not a very useful program when you have hundreds of thousands of records you 
  18. want sorted in position 25 for 12 characters.
  19.  
  20. CUSort implements what is known as a virtual sort, allowing you to sort more 
  21. than will fit in RAM at one time.  It does this by sorting manageable 
  22. portions of the input file first, and then merging these pre-sorted lists to 
  23. form the final output file.  In theory, two billion records can be sorted in 
  24. one run. In actual practice, the number of records will be limited only by 
  25. the amount of available disk or expanded memory (EMS) capacity, and, of 
  26. course, the amount of time you're willing to wait. 
  27.  
  28. CuSort Revision history
  29.  
  30. version 2.3 - April 1993
  31.   o  Fixed the comparison routine to give proper results when two records
  32.      of different lengths are processed. Prior to v2.3 the compare terminated 
  33.      at the length of the longer record.  All record lengths are now padded 
  34.      to the length of the larger prior to testing equality. Thanks to
  35.      Ray Schildknecht for the bug report.
  36.   
  37.   o  Added the capability to sort individual fields in decending mode. See
  38.      use documentation for details.
  39.  
  40. version 2.2 - November 1992
  41.   o  Fixed a bug in the parameter parsing which would not set the descending 
  42.      sort option properly.
  43.      Changed the version number to x.x vs x.xx
  44.  
  45. version 2.16 - February 1992
  46.   o  Added the quiet mode operation (/Q) at the request of Dave Holley of 
  47.      MicroMax Computer Services Corp.
  48.  
  49. version 2.1 - November 1990
  50.   o  Option E added.  Do not use Expanded memory even if available.
  51.  
  52.   o  At an abnormal termination CuSort now removes its work files.
  53.  
  54.   o  Bugs fixed - 
  55.   o   Option L flag was never initialized so it could be invoked at any 
  56.       time by leftover memory contents.
  57.  
  58.   o   StdIn was not always used properly.
  59.  
  60.   o   The D (remove duplicates) & L (sort by length) options were added at 
  61.       the request of Terry Hall of Illinois.  This addition allowed me to 
  62.       find the /B option bug also.
  63.  
  64. version 2.0 - August 1990
  65.   o   Option D Directory changed to Option R Redirect.
  66.  
  67.   o   Option D Added to indicate "No duplicates to be written."
  68.  
  69.   o   Option L added to indicate "Sort by record length."
  70.  
  71.   o   Bug fixed - if blank record option (/B) not selected the program would 
  72.       not produce an output file.
  73.  
  74. CUSort's operation is determined by the command line parameters you
  75. give it when the program is started.  The command line format is
  76.  
  77.      CuSort [options] <inputFile >outputFile
  78.  
  79.      Options:
  80.  
  81.          /-   Sort all fields in descending order. The default is
  82.               ascending order. See the /S command to sort an
  83.               individual field in descending order. When sorting by 
  84.               fields (/S command) this parameter will result in the 
  85.               entire file being sequenced in descending order from 
  86.               the major sort field to the minor sort field.
  87.  
  88.          /I   Ignore upper/lower case.  All input is compared
  89.               as if it were upper case.
  90.  
  91.          /Q   Run in quiet mode.  No output is made to the StdErr
  92.               file. (StdErr is normally defined to the screen)
  93.  
  94.          /R xx     Redirect temporary sort files to directory
  95.                    xx. (files will be deleted before program
  96.                    terminates.)
  97.  
  98.          /T   Trim records. This parameter allows you to
  99.               remove blanks at the beginning and end of the
  100.               input records. Sequencing is done prior to
  101.               trimming.
  102.  
  103.          /B   Do not write blank records. All blank records
  104.               found during the input phase will be discarded.
  105.  
  106.          /D   Do not write duplicate records.
  107.  
  108.          /L   Sort by length of record. /S parm is ignored.
  109.  
  110.          /S c,l[-]    
  111.               Sort fields ... c = column; l = length. You may
  112.               have a maximum of 6 /S fields during any single
  113.               run. They must be placed in priority sort order. 
  114.               Placing a minus sign '-' anywhere in the parameter 
  115.               will cause that field to be sorted in descending 
  116.               order.
  117.  
  118.          /E   Do not use Expanded Memory (EMS) even if that memory
  119.               is available.
  120.  
  121. Caution:  When using the descending options, the option can only be 
  122.           set once for each field.  If you use the global [/-] option
  123.           and then set a sort field in descending or [/S c,l-] the 
  124.           sequence will still be descending. In other words, using both
  125.           options will not reverse the ordering.
  126.  
  127.      Examples:
  128.  
  129.      CuSort /B /S 1,25 < textin.dat > textout.dat
  130.           This example sorts just like the DOS sort except that the
  131.           sort field size is limited to 25 characters and any blank
  132.           records found during sorting will not be included in the
  133.           output file.
  134.  
  135.      CuSort /- /I < textin.dat > textout.dat
  136.           This example sorts the entire file, including blank
  137.           records in descending sequence. Lower case and Upper case
  138.           are sorted together.
  139.  
  140.      CuSort /I /S 10,5- /S 2,6 < textin.dat > textout.dat
  141.           This example sorts on column 10 for 5 characters as the
  142.           major sort field (descending order) and column 2 for 6 
  143.           characters as the minor sort field (ascending order). 
  144.           Upper and lower case characters are sorted together.
  145.  
  146.      CuSort /- /I /S 10,5 /S 2,6 < textin.dat > textout.dat
  147.           This example sorts on column 10 for 5 characters as the
  148.           major sort field (descending order) and column 2 for 6 
  149.           characters as the minor sort field (ascending order). The 
  150.           entire file is sorted in descending sequence and upper and 
  151.           lower case characters are sorted together.
  152.  
  153.      CuSort /L /D /Q <textin >textout
  154.           This example will sort records by length of record and
  155.           will remove any duplicate records. Operate in quiet mode
  156.     ORDER FORM
  157.  
  158.      Name: ------------------------------------------------------
  159.  
  160.      Address: ---------------------------------------------------
  161.  
  162.      City: ---------------------------- State: ---- Zip: --------
  163.  
  164.      Phone: (     ) -------------------------------
  165.  
  166.      Credit card:   type -  Visa     Mastercard
  167.  
  168.      Card number: ------------------------------ expires ---/---
  169.      
  170.      Name on card: ---------------------------------------------
  171.  
  172. ----------------------------------------------------------------
  173.      CuSort latest version . . . . . . . . . . . . . . . $ 24.00
  174.           Includes the following..
  175.                Current disk direct from author
  176.                Telephone support
  177.                Notification of further upgrades and
  178.                     products.
  179.  
  180.      Colorado residents include 3% state tax and 
  181.           appropriate local tax. . . . . . . . . . . . . .$ -----
  182.  
  183.                          Shipping & Handling . . . . . . .$  5.00
  184.  
  185.                          Total included  . . . . . . . . .$ -----
  186.  
  187.  
  188. ----------------------------------------------------------------
  189. Order in one of three ways... Fill out this form and mail to: 
  190.      Micro System Solutions
  191.      5417 S. Cimarron Rd.
  192.      Littleton, CO 80123
  193. - or -
  194.      Call 1-(800) 421-1789 or 1-(300) 795-7653 (credit card orders)
  195. - or-
  196.      Leave a Compuserve CMail (Compuserve Mail) message for
  197.      Micro System Solutions (Fred C. Hill PPN 76060,102) with all
  198.      of the information above. (credit card orders or information
  199.      only please, DO NOT leave messages with credit card numbers
  200.      in the forum areas)
  201. ----------------------------------------------------------------
  202.  
  203.      
  204.